home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / nemo01.zip / NEMO.DOC next >
Text File  |  1993-06-15  |  11KB  |  324 lines
  1.  
  2.          Captain Nemo for OS/2 2.0
  3.         Version 0.1,  June 14, 1993
  4.  
  5.         Copyright (C) 1993 by Adam Mirowski
  6.  
  7. $Id: nemo.doc 1.21 93/06/15 05:24:38 ROOT_DOS Exp $
  8.  
  9. Introduction
  10. ------------
  11.  
  12. "Captain Nemo" is a text-mode shell program for OS/2.
  13. It tries to imitate the Norton Commander (R) for DOS
  14. v.2 as closely as possible and yet realize a smooth
  15. integration with OS/2 features. I started writing it
  16. last March, after receiving my copy of NC for OS/2
  17. and not being satisfied by it.
  18.  
  19. This version 0.1 is an alpha release. It is free, but
  20. incomplete, buggy and full of possibly useless checks
  21. that slow down execution and waste memory.
  22.  
  23. Captain Nemo version 0.1 is distributed in the hope that
  24. it will be useful, but WITHOUT ANY WARRANTY; without even
  25. the implied warranty of MERCHANTABILITY or FITNESS FOR A
  26. PARTICULAR PURPOSE. You can use at your own risk, and
  27. report whatever problems you have encountered with it.
  28. You are free to copy this software ONLY if you include this
  29. document file with it. You may NOT charge anyone for a copy
  30. of this software other than a small copying fee. You may NOT
  31. include this software with any commercial software without
  32. the written consent of the author.
  33.  
  34. As I said, this version is free, but donations will be
  35. gratefully accepted.
  36.  
  37. You can contact me either by writing an e-mail to:
  38.  
  39.     Adam Mirowski <mir@chorus.fr>
  40.  
  41. or sending a letter to:
  42.  
  43.     Adam Mirowski
  44.     Residence Les Cypres
  45.     10, rue Caruel de Saint-Martin
  46.     F-78150 Le Chesnay
  47.     FRANCE
  48.  
  49. You can phone me at +33 (1) 30-64-82-74 (business) or
  50. +33 (1) 39-54-27-34 (home). Please note that I live in
  51. the GMT+2 time zone.
  52.  
  53. Features
  54. --------
  55.  
  56. Since you are probably more interested in what is
  57. missing than in what is present, let's start by a
  58. non-features list.
  59.  
  60. Currently there is no:
  61.  
  62.     - F9/[LR]/T    tree panels
  63.     - Alt-F10    NCD tree
  64.     - Alt-F4    built-in editor
  65.     - <auto>    mouse support
  66.     - <auto>    country information utilisation
  67.             (the  DD/MM/YY  HH:MM  format is used)
  68.     - <auto>    scrollbars in the user menu box (which is
  69.             limited to 19 entries)
  70.     - <auto>    'dirinfo' display in "Info" panes
  71.  
  72. These features are special to NEMO:
  73.  
  74.     - <auto>    specific "Hpfs" directory format for HPFS disks,
  75.             allowing up to 16 visible chars on 80 char wide
  76.             displays and up to 38 on 132 chars.
  77.             Also used in the logical naming mode.
  78.     - F9/O/M    Mini-Status windows can show up to 38 or 64 first
  79.             chars of filenames, if needed.
  80.     - Alt-F5    "logical file naming" mode in which files can be
  81.             identified and manipulated using arbitrary logical
  82.             names rather than hardware 8.3 MS-DOS names.
  83.             This makes FAT disks appear like HPFS ones,
  84.             and is also compatible with the Workplace Shell
  85.             naming (you can rename each other's objects using
  86.             alternatively NEMO and WPS).
  87.     - ^F6        logical filename creation
  88.     - <auto>    extended attributes support: EAs follow owning files
  89.             when those are copied or moved;
  90.     - Alt-F6    132 column display support
  91.       F9/C/L
  92.     - F9/O/R    screen-saver (didn't exist in NC v.2)
  93.     - <auto>    the extension file can have an unlimited length
  94.     - F9/O/V    the viewer can be set to an external executable
  95.     - <auto>    history elimination is case-sensitive
  96.     - grey*        inversion of file tags by mask
  97.  
  98. These features are shared with the reference program:
  99.  
  100.     - <auto>    a 100% NC for DOS v.2 look including colors;
  101.     - F9/[LR]/B    "Brief" and
  102.       F9/[LR]/L    "Long" directory formats for FAT disks;
  103.     - <auto>    fully functional command line editor, also in all
  104.             dialog boxes, including a "hysteresis" backscroll.
  105.     - <auto>    interaction between panels and command line,
  106.       ^Enter    including filename pasting
  107.     - <auto>    full and unlimited length extension file nemo.ext
  108.             with !, .!, !:, !\ and !! handling;
  109.     - X:   CD..    transparent capture of disk and directory changes
  110.       CD\  CD    and display performed using the command line.
  111.       CD <dir>    Error messages are native OS/2 messages for
  112.             full OS/2 CMD.EXE illusion;
  113.  
  114.     - INS         file tagging, preserved between shell command
  115.             execution and pane hiding;
  116.     - DEL        char deletion;
  117.     - grey-        file untagging by mask;
  118.     - grey+        file tagging by mask;
  119.     - Alt-...    file selecting by initials;
  120.     - arrows    operate differently according to the
  121.             type of the current pane, if any;
  122.     - HOME/END    operate  differently according to
  123.             the type of the current pane, if any;
  124.     - PageUp/Down    100% NC's funny logic;
  125.  
  126.     - F1        display help page;
  127.     - F2        nemo.mnu user menu, local and global;
  128.     - F3        viewer (can be disabled and set to an external
  129.             executable through Options/Viewer);
  130.     - F4        external editor (name can be set through a
  131.             Options/Editor);
  132.     - F5        file copying, individual and tagged, with
  133.             full wildcard support and full set of
  134.             informational and error messages;
  135.     - F6        file moving, directory renaming, with full
  136.             wildcard support and full set of informational
  137.             and error messages;
  138.     - F7        directory creation;
  139.     - F8        file/dir deletion, individual and tagged;
  140.     - F9        activate menu bar, turn on "Left" or "Right"
  141.             accordingly to the current panel;
  142.     - F10        quit
  143.  
  144.     - Alt-F1    disk selection
  145.     - Alt-F2    disk selection
  146.     - Alt-F3    view currently selected file
  147.     - Alt-F4    edit currently selected file using built-in editor
  148.             (the external editor is always used for the moment)
  149.     - Alt-F5    Toggle usage of logical names
  150.     - Alt-F6    Toggle 132 column mode vs. 80 column mode
  151.     - Alt-F7    Find file
  152.     - Alt-F8    history box
  153.     - Alt-F9    43/50 lines
  154.     - Alt-F10    <not yet supported>
  155.  
  156.     - Shift-F1    <no action>
  157.     - Shift-F2    <no action>
  158.     - Shift-F3    arbitrary file viewing
  159.     - Shift-F4    arbitrary file editing
  160.     - Shift-F5    file copying/renaming by mask
  161.     - Shift-F6    file moving/renaming by mask
  162.     - Shift-F7    directory creation
  163.     - Shift-F8    file/dir deletion
  164.     - Shift-F9    save nemo.ini binary config file
  165.     - Shift-F10    <no action>
  166.  
  167.     - Ctrl-F1    turning left pane on/off
  168.     - Ctrl-F2    turning right pane on/off
  169.     - Ctrl-F3    <no action>
  170.     - Ctrl-F4    <no action>
  171.     - Ctrl-F5    <no action>
  172.     - Ctrl-F6    <no action>
  173.     - Ctrl-F7    <no action>
  174.     - Ctrl-F8    <no action>
  175.     - Ctrl-F9    <no action>
  176.     - Ctrl-F10    <no action>
  177.  
  178.     Ctrl-key combinations:
  179.     - ^A        word left
  180.     - ^B        keybar switching
  181.     - ^C        <no action>
  182.     - ^D        one char forward
  183.     - ^E        previous history entry
  184.     - ^F        word right
  185.     - ^G        delete char under cursor
  186.     - ^H        backspace
  187.     - ^I        switch to other panel if any
  188.     - ^J        paste pane selection into command line
  189.     - ^K        killing line end
  190.     - ^L        info panels
  191.     - ^M        execute command line
  192.     - ^N        open menu bar and select current panel menu
  193.     - ^O        panels on/off
  194.     - ^P        non-current pane switching
  195.     - ^Q        <no action>
  196.     - ^R        changing disk for current pane
  197.     - ^S        one char backward
  198.     - ^T        delete word right
  199.     - ^U        swap panels
  200.     - ^W        delete word left
  201.     - ^X        next command
  202.     - ^Y        delete command line
  203.     - ^Z        <no action>
  204.     - ^Home        goto start of line
  205.     - ^End        goto end of line
  206.     - ^BS        delete word right (same funny semantics
  207.             for finding the char to stop on as in NC)
  208.  
  209.     - F9/[LR]/B    brief directory format
  210.     - F9/[LR]/F    full directory format
  211.     - F9/[LR]/I    information
  212.     - F9/[LR]/O    pane on/off switching
  213.     - F9/[LR]/[NXSMU]
  214.             all sorting options
  215.     - F9/[LR]/R    directory re-read
  216.     - F9/[LR]/D    drive selection
  217.  
  218.     - F9/F/H    help
  219.     - F9/F/U    user menu
  220.     - F9/F/V    view file
  221.     - F9/F/E    edit file
  222.     - F9/F/C    copy files
  223.     - F9/F/M    move files
  224.     - F9/F/M    make directory
  225.     - F9/F/D    delete files/directory
  226.     - F9/F/Q    quit NEMO
  227.  
  228.     - F9/C/H    history menu
  229.     - F9/C/E    EGA lines
  230.     - F9/C/S    swap panels
  231.     - F9/C/L    toggle 132 column mode
  232.     - F9/C/.    toggle logical name usage
  233.     - F9/C/P    panels on/off
  234.     - F9/C/C    compare directories (warning: like in NC, comparing is
  235.             only on existence/date/time. Not on size, attributes
  236.             or EAs.
  237.     - F9/C/M    menu file edit
  238.     - F9/C/X    extension file edit
  239.  
  240.     - F9/O/C    color dialog box
  241.     - F9/O/C/B    black and white display mode
  242.     - F9/O/C/C    color display mode
  243.     - F9/O/C/L    laptop display mode
  244.     - F9/O/A    auto menus on/off
  245.     - F9/O/P    path prompt switching vs. disk-only prompt
  246.     - F9/O/K    key bar on/off
  247.     - F9/O/F    full screen vs. half screen
  248.     - F9/O/I    ins moves down on/off
  249.     - F9/O/L    clock on/off
  250.     - F9/O/V    viewer selection
  251.     - F9/O/V/B    built-in viewer selection
  252.     - F9/O/V/E    external viewer selection and defining
  253.     - F9/O/E    editor selection
  254.     - F9/O/E/E    external editor selection and defining
  255.     - F9/O/R    screen-saver time-out adjusting
  256.     - F9/O/S    save setup
  257.  
  258. Known bugs
  259. ----------
  260.     - In the Viewer, when looking for strings in binary files,
  261.       strings located behind null characters are not found.
  262.  
  263.     - Color scheme management has been tested only on a VGA card,
  264.       and gives some funny results in Hercules mode.
  265.  
  266.     - Disk letter spacing in disk selection dialog boxes is non-
  267.       conforming when the number of disks is between 8 and 14.
  268.  
  269.     - For a yet unknown reason, ^P doesn't arrive till Nemo.
  270.       CP/M heritage?
  271.  
  272.     - When copying FAT files to HPFS volumes, Nemo doesn't
  273.       substitute '&' in file names, whereas the '&' character
  274.       seems to have a special meaning on HPFS volumes.
  275.  
  276. Remarks
  277. -------
  278.  
  279. Nemo uses DOS file selection mechanism, ie. the last dot
  280. of a file name is considered as "the" dot and the other
  281. are seen as ordinary chars.
  282.  
  283. OS/2 locks files and directories when used or current for
  284. a process, so you cannot remove them, nor change their physical
  285. or logical names.
  286.  
  287. Use ^ in logical names to obtain a newline effect on the
  288. WPS desktop. You can even enter the ^ in the WPS, and as
  289. soon as you validate the name change it will be transformed
  290. into a visual newline.
  291.  
  292. Logical name support is still very uncomplete and somewhat
  293. incoherent. Physical names are never updated when changing
  294. logical ones. It is possible to have two files under the
  295. same logical name, for example when copying a non-8.3 file
  296. from an HPFS disk to a FAT disk and then back.
  297.  
  298. If you want an arbitrary number of screen lines (columns
  299. must be either 80 or 132), execute the OS/2 mode command
  300. before or from within Nemo.
  301.  
  302. The initial message box will not be displayed if Nemo
  303. founds a nemo.ini setup file.
  304.  
  305. Captain Nemo is written in a relatively portable C code.
  306. It has been written mostly on DOS, then adapted to both
  307. OS/2 1.x and OS/2 2.x native system interfaces and their
  308. quirks.
  309. I see no sense in releasing the DOS binary, since the
  310. original is slightly speedier and takes much less memory
  311. when executing external programs, but can provide the
  312. OS/2 1.x compatible version on request.
  313.  
  314. Acknowledgements
  315. ----------------
  316. Thanks to Benoit Poulot and Kai Uwe Rommel for their help!
  317.  
  318. Trademarks
  319. ----------
  320.  
  321. "Norton Commander" (R) is a registered trademark of the
  322. Symantec Corporation.
  323.  
  324.